This update to ODF Release 2 contains files necessary to update the CodeWarrior support of Release 2 to version 10 of CodeWarrior. The update consists of two components. The first component is an AppleScript applet called “ODF CW10 Conversion Script.” When executed, this script sequentially opens all of the CodeWarrior projects included in the ODF 2 release in CodeWarrior, and instructs CodeWarrior to convert the project to the CW 10 format. The second component is a collection of source and header files that are drop-in replacements for files that shipped with the ODF Release 2 distribution.
Preparing a CodeWarrior 10 Environment
Before installing this update, you should prepare a CodeWarrior 10 build environment for use with ODF. Begin by installing CodeWarrior on your hard drive. Once you have installed CodeWarrior, carry out the following steps:
• Copy the ODFRC plugin for CodeWarrior from your CodeWarrior 9 environment to your CodeWarrior 10 environment. The ODFRC plugin can be found in a subfolder of the “Getting Started:CodeWarrior Developement” folder of the ODF Release 2 distribution. The ODFRC plugin should be placed in the folder "Metrowerks CodeWarrior:CodeWarrior Plugins:Compilers:".
• Hide the “OpenDoc Utilities” headers that shipped with CodeWarrior 10. This is necessary because ODF includes a copy of the OpenDoc Utilities headers modified for use with ODF. To hide this directory, rename the folder “Metrowerks CodeWarrior:MacOS Support:Headers:OpenDoc Headers:OpenDoc Utilities:" to “Metrowerks CodeWarrior:MacOS Support:Headers:OpenDoc Headers:(OpenDoc Utilities):". Parenthesizing the name of this folder will cause CodeWarrior to ignore the contents of the folder when searching for included header files.
• Copy the Cyberdog SDK from your CodeWarrior 9 folder to your CodeWarrior 10 folder. If you installed it into your CodeWarrior 9 environment, it can be found at “Metrowerks CodeWarrior:MacOS Support:Headers:Cyberdog SDK:". The CyberDog SDK shipped as part of the ODF Release 2 distribution in a subfolder of the “Getting Started:CodeWarrior Development” folder. The “Cyberdog SDK” folder should be placed within the “Metrowerks CodeWarrior:MacOS Support:Headers:” folder of your CodeWarrior 10 environment.
Installing the Update
This conversion package contains four files that replace files that shipped as part of ODF Release 2. Begin installing this update by replacing the ODF Release 2 files with the versions included in this update.
Replace the following files with the included replacements of the same name:
“ODFDev:ODF:Found:FWCommon:FWPriMem.cpp”
“ODFDev:ODF:Found:FWCommon:FWPriMem.h”
“ODFDev:ODF:Found:FWMemory:FWNew.h”
“ODFDev:ODF:Found:FWODExce:FWODExce.cpp”
Once you have replaced the files, execute the “ODF CW10 Conversion Script” AppleScript applet. The script will ask you to locate your copy of the CodeWarrior IDE. Select the version of the CodeWarrior IDE that shipped with CodeWarrior 10. Deleting CodeWarrior release 9 from your system before executing this script will guarantee that the correct version of CodeWarrior is executed.
The script will open each of the CW9 projects included with ODF Release 2 in CodeWarrior. CodeWarrior will silently convert each project to the CodeWarrior 10 format. When CodeWarrior converts the project, it will create a copy of the original, unconverted project. This script will delete each the copy of each CW9 project as it progresses through the conversion.
Once you have executed the update script, you will need to rebuild ODF using the “ODF Builder” application. After ODF has been rebuilt, you can convert and rebuild your part projects.
Caveat
After updating to CodeWarrior 10, you will begin getting a link warning every time you link an ODF-based OpenDoc part. The link warning will read, “Link Warning : ignored duplicate resource ‘cfrg’(0) in ‘*Linker-Generated*’”. This warning occurs when CodeWarrior attempts to create a 'cfrg' resource for the part being built, and encounters an existing 'cfrg' resource that was generated from the part's “Part.r” resource file. CodeWarrior 9 silently ignored this condition - CodeWarrior 10 warns. The default 'cfrg' that CodeWarrior is trying to create is inaccurate - it does not contain the SOM module information present in the 'cfrg' resources we include with our parts. It is important that you not try to work around this warning by removing the 'cfrg' resource from your Part.r resource file. There is no workaround at this time - the warning is annoying, but the linked part created by CodeWarrior is fine.
